home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / Online / Epic4 / share / epic / help / 5_programming / on / ctcp_reply < prev    next >
Encoding:
Text File  |  2001-03-21  |  1.1 KB  |  35 lines
  1. Synopsis:
  2.    on [<modes>]ctcp_reply [<serial#>] [-|^]<match> { <action> }
  3.  
  4. Description:
  5.    This hook is triggered whenever the client receives a CTCP reply from
  6.    another client.  Note that the client doesn't necessarily need to send
  7.    any CTCP messages to receive a "reply".
  8.  
  9. Parameters:
  10.    $0    nickname of user sending reply
  11.    $1    CTCP command being replied to
  12.    $2-   actual reply to CTCP command (varies, depends on $1)
  13.  
  14. Examples:
  15.    To customize the appearance of CTCP reply strings:
  16.       on ^ctcp_reply "*" {
  17.          echo *** Reply from $0 for CTCP $1 request: $2-
  18.       }
  19.  
  20. See Also:
  21.    ctcp(1); on(5) ctcp
  22.  
  23. Restrictions:
  24.    Automatic replies (MSGs, CTCPs, NOTICEs, etc.) to the sender with this
  25.    hook are explicitly prohibited.  The protocol disallows it, and the
  26.    client will do everything in its power to prevent it.  Any attempt will
  27.    result in an error message.
  28.  
  29. Bugs:
  30.    There is no way (from within this hook) to know who the actual target
  31.    of the reply is.  This could be a problem, since it is trivial to send
  32.    bogus replies, and there is no way to tell if the client, or a channel,
  33.    was the target.
  34.  
  35.